PPSCLIENT001 (PAYMENT_SERVICE_CLIENT_CONFIG_XML)

Prerequisites

• You must have the PAYMENT_SERVICES license to see and use this feature in N4.

Use this setting to attach an XML file that contains the merchant and vendors that you use for the payment services. N4 supported payment gateways include Paymentech, Paypal, and iTransact.

The XML file is based on the custom_processor.xsd. Any custom configuration must be handled by Navis Professional Services and verified by client application developers. The PPSCLIENT001 configuration setting has a lifecycle associated with it. Therefore, when you update this configuration setting, N4 reloads any active payment service. In addition, if you reconfigure an active service, N4 reloads this setting.

Navis recommends that you update a service or this setting when there is no payment activity.

See also, FRMSECURITY023 (SYSTEM_AUTHENTICATION_METHOD) and FRMSECURITY025 (EXTERNAL_AUTHENTICATION_PROVIDERS_CONFIG_XML)

To use this file for testing, ensure that you comment out the URL of the vendor, if it is a live URL, so that you do not post transactions to a bank.

The following code segment represents a sample XML file that you can use to provide the merchant and vendor information for your payment services:

<?xml version="1.0" encoding="utf-8"?>

<!--suppress XmlUnboundNsPrefix -->

<PPSConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

           xsi:noNamespaceSchemaLocation="schema/custom_processor.xsd">

    <merchantInfo>

        <name>MyCity Terminals LLC</name>

        <address>

            <addr1>121 Maritime Boulevard</addr1>

            <city>Port of Uron</city>

            <region>CA</region>

            <postalCode>11111</postalCode>

            <countryCode>US</countryCode>

        </address>

    </merchantInfo>

    <!--  ProcessorInfo  -->

    <processorInfo name="PaymentechGateway">

        <!-- URL of the vendor. Specify the correct URL if it is not a test environment.

        Certification: [https://ws2.paymentech.net/PaymentechGateway/authorize]

        Production: [https://ws2.paymentech.net/PaymentechGateway/authorize]

        -->

        <vendorInterface>

            <param name="URL" value="https://ws2.paymentech.net/PaymentechGateway/authorize"/>

        </vendorInterface>

    </processorInfo>

    <!-- CustomInfo -->

    <customInfo>

        <!-- Terminal Name <merchantID>1111111111111111111</merchantID>  -->

        <!-- Vendor Merchant ID -->

        <merchantID>1111111111111111111</merchantID>

        <currencyCode>USD</currencyCode>

        <CCProcessingLevel>1</CCProcessingLevel>

        <!--  Processor Configuration parameter values  -->

        <configurationParams>

            <param name="industryType" value="EC"/>

            <param name="bin" value="000002"/>

            <param name="merchantID" ref="merchantID"/>

            <param name="terminalID" value="001"/>

        </configurationParams>

        <!--  Transaction support  -->

        <transactionParams>

            <pmtAuthorize>

                <!--  Options enabled  -->

                <options>

                    <option name="ccInfo"/>

                    <option name="useCustomerProfile"/>

                    <option name="cvn"/>

                    <option name="avs"/>

                </options>

            </pmtAuthorize>

            <pmtCapture/>

            <pmtAdjust/>

            <pmtVoid/>

            <customerProfileCre/>

            <customerProfileUpd/>

            <customerProfileDel/>

            <customerProfileGet/>

        </transactionParams>

    </customInfo>

</PPSConfig>

To use iTransact gateway, modify the configuration parameters in the xml file as follows:

<configurationParams>

<param name="industryType" value="EC"/>

<param name="bin" value="000002"/>

<param name="merchantID" ref="merchantID"/>

<param name="terminalID" value="001"/>

<param name="type" value="REST"/>

<param name="apiKey" value="apikey"/>

<param name="base64APIUserName" value="apiusername"/>

</configurationParams>